home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / initnsema.z / initnsema
Encoding:
Text File  |  2002-10-03  |  3.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. iiiinnnniiiittttnnnnsssseeeemmmmaaaa((((DDDD3333XXXX))))                                                  iiiinnnniiiittttnnnnsssseeeemmmmaaaa((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _iiii_nnnn_iiii_tttt_nnnn_ssss_eeee_mmmm_aaaa - initialize a synchronizing semaphore to a given value
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _""""_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_""""
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _""""_ssss_yyyy_ssss_////_ssss_eeee_mmmm_aaaa_...._hhhh_""""
  14.  
  15.      _iiii_nnnn_iiii_tttt_nnnn_ssss_eeee_mmmm_aaaa_((((_ssss_eeee_mmmm_aaaa______tttt _****_s_e_m_a_p_,,,, _iiii_nnnn_tttt _v_a_l_,,,, _cccc_hhhh_aaaa_rrrr _****_n_a_m_e_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _iiii_nnnn_iiii_tttt_nnnn_ssss_eeee_mmmm_aaaa initializes an IRIX synchronizing semaphore (a structure of
  19.      type _s_e_m_a__t). Use synchronizing semaphores to synchronize multiple
  20.      processes. You must allocate a semaphore before you can use it in a
  21.      semaphore operation, such as _pppp_ssss_eeee_mmmm_aaaa or _vvvv_ssss_eeee_mmmm_aaaa. You can declare semaphores
  22.      in line by using the _s_e_m_a__t type, or you can allocate them dynamically by
  23.      using the kernel memory allocator, _kkkk_eeee_rrrr_nnnn______mmmm_aaaa_llll_llll_oooo_cccc(D3X). In the case of an
  24.      already allocated semaphore struct, initsema fills it.
  25.  
  26.      The _v_a_l parameter expects the initial value to which you want to set the
  27.      semaphore. The _n_a_m_e parameter of _iiii_nnnn_iiii_tttt_nnnn_ssss_eeee_mmmm_aaaa expects a pointer to an eight
  28.      character string that contains the name you want to assign to the
  29.      semaphore. This name may be used by debugging utilities.
  30.  
  31.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  32.      None
  33.  
  34.    SSSSeeeeeeee AAAAllllssssoooo
  35.      _iiii_nnnn_iiii_tttt_nnnn_ssss_eeee_mmmm_aaaa______mmmm_uuuu_tttt_eeee_xxxx(D3X), _cccc_pppp_ssss_eeee_mmmm_aaaa(D3X), _cccc_vvvv_ssss_eeee_mmmm_aaaa(D3X), _pppp_ssss_eeee_mmmm_aaaa(D3X), _vvvv_ssss_eeee_mmmm_aaaa(D3X),
  36.      _ssss_llll_eeee_eeee_pppp(D3), _vvvv_pppp_ssss_eeee_mmmm_aaaa(D3X), _SSSS_LLLL_EEEE_EEEE_PPPP______AAAA_LLLL_LLLL_OOOO_CCCC(D3), _SSSS_LLLL_EEEE_EEEE_PPPP______DDDD_EEEE_AAAA_LLLL_LLLL_OOOO_CCCC(D3)
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.